home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / pbm / texts.lzh / orig / README < prev    next >
Text File  |  1992-04-23  |  5KB  |  102 lines
  1. [ This is the original README from the Unix PBMPlus.  I only deleted the ]
  2. [ Installation and Contents parts.  See the amiga.readme file for more   ]
  3. [ information, especially on the Support and Copyrights parts.      Ingo ]
  4.  
  5.                   Extended Portable Bitmap Toolkit
  6.                       Distribution of 10dec91
  7.                    Previous distribution 30oct91
  8.  
  9.  
  10. PBMPLUS is a toolkit for converting various image formats to and from
  11. portable formats, and therefore to and from each other.  The idea is,
  12. if you want to convert among N image formats, you only need 2*N
  13. conversion filters, instead of the N^2 you would need if you wrote each
  14. one separately.
  15.  
  16. In addition to the converters, the package includes some simple tools
  17. for manipulating the portable formats.
  18.  
  19. The package is broken up into four parts.  First is PBM, for bitmaps (1
  20. bit per pixel).  Then there is PGM, for grayscale images.  Next is PPM,
  21. for full-color images.  Last, there is PNM, which does content-independent
  22. manipulations on any of the three internal formats, and also handles
  23. external formats that have multiple types.
  24.  
  25. The parts are upwards compatible: PGM reads both PGM and PBM files and
  26. writes PGM; PPM reads all three and writes PPM; and PNM reads all three
  27. and writes, usually, the same type as it read.  Whenever PNM makes an
  28. exception and "promotes" a file to a higher format, it lets you know.
  29.  
  30.  
  31. SUPPORT
  32.  
  33. I've tested this stuff under SysV and BSD, on Sun 3's 4's and 386's and
  34. Sequents and Vaxen and HPs, with cc and gcc.  Nevertheless, I'm sure bugs
  35. remain, and portability to systems like Amigas and IBM compatibles is
  36. an interesting question.  Feedback is welcome; send bug reports,
  37. enhancements, etc. to this address:
  38.  
  39.     jef@well.sf.ca.us
  40.     apple!well!jef
  41.  
  42. When sending bug reports, always include the output from running any
  43. PBMPLUS program with the -version flag.  Also include the type of
  44. system you are on, what compiler you used, and whether you are using
  45. Makefiles or Imakefiles.  I try to respond to bug reports and enhancements
  46. promptly; say, within a week.
  47.  
  48. Also, if there is a new format or feature you would like to have added
  49. to the package, feel free to drop me a line.  If it's a format, include
  50. whatever documentation you have, and if possible a uuencoded sample.
  51. My response time will depend on how busy I am, and how easy the job
  52. looks.  If you need it right away, or it's a complicated job, you might
  53. consider paying me; lately, that's how a lot of work on the package has
  54. gotten done.
  55.  
  56. Finally, if you have access to Usenet, there's a newsgroup called
  57. alt.graphics.pixutils which is specifically for discussion of image
  58. conversion and editing packages such as PBMPLUS.  Posting stuff there
  59. is even better than mailing it to me, since it lets other people help
  60. out with the answers.
  61.  
  62.  
  63. HOW TO FIND THE RIGHT CONVERTER
  64.  
  65. Some people get confused by all the different names.  If you want to
  66. convert a pbm file to a Sun raster file, is it pbmtorast, pgmtorast,
  67. ppmtorast, or pnmtorast?  In this case some of the confusion might be
  68. because previous versions of the package did in fact have both
  69. pbmtorast and ppmtorast.  But mostly it's just too many different
  70. things to hold in your short term memory.  Fine, so don't even try to
  71. remember what's what.  That's what computers are for.  Unix, at least
  72. BSD Unix, has this great indexing feature on the "man" program.  You
  73. say "man -k <keyword>" and it gives you all the one-line descriptions
  74. with that keyword in them.  All the PBMPLUS man pages have nice useful
  75. one-line descriptions, that mention all the relevant keywords.  Try it,
  76. you'll like it.
  77.  
  78.  
  79. COPYRIGHTS
  80.  
  81. All the software in this package, whether by me or by a contributer,
  82. has a copyright similar to this one:
  83.  
  84.     Permission to use, copy, modify, and distribute this software and its
  85.     documentation for any purpose and without fee is hereby granted, provided
  86.     that the above copyright notice appear in all copies and that both that
  87.     copyright notice and this permission notice appear in supporting
  88.     documentation.  This software is provided "as is" without express or
  89.     implied warranty.
  90.  
  91. Many people get confused by this legalese, especially the part about
  92. "without fee".  Does this mean you can't charge for any product that
  93. uses PBMPLUS?  No.  All it means is that you don't have to pay me.
  94. You can do what you want with this software.  Build it into your
  95. package, steal code from it, whatever.  Just be sure to let people
  96. know where it came from.
  97.  
  98. [ Remember that this copyright only applies to the PBMPlus SOURCES, not  ]
  99. [ the Amiga binaries from my port.  In fact, there are some heavy dis-   ]
  100. [ tribution restrictions on them.  Read the file `amiga.readme' in the   ]
  101. [ texts archive for more information on this subject.               Ingo ]
  102.